.TH GREP-EXCUSES 1 "Debian Utilities" "DEBIAN" \" -*- nroff -*-
.SH NAME
grep-excuses \- search the testing excuses files for a specific maintainer
.SH SYNOPSIS
\fBgrep-excuses\fR [\fIoptions\fR] [\fImaintainer\fR|\fIpackage\fR]
.SH DESCRIPTION
\fBgrep-excuses\fR downloads the autoremovals and update_excuses.html files
and greps them
for the specified maintainer or package name.  The \fBwget\fR package is
required for this script.  If no name is given on the command line,
first the environment variable \fBDEBFULLNAME\fR is used if it is
defined, and failing that, the configuration variable described below
is used.
.SH OPTIONS
.TP
\fB\-\-no-conf\fR, \fB\-\-noconf\fR
Do not read any configuration files.  This can only be used as the
first option given on the command-line.
.TP
\fB\-\-wipnity\fR, \fB\-w\fR
Get information from <https://qa.debian.org/excuses.php>.
One or more package names must be given when using this option.
.TP
.B \-\-help
Show a brief usage message.
.TP
.B \-\-version
Show version and copyright information.
.TP
.B \-\-autopkgtests
Investigate and show autopkgtest (ci.debian.net) failures
in your packages
but apparently caused by new versions of other packages
trying to migrate.
.RB ( \-\-no-autopkgtests
can be used to override GREP_EXCUSES_AUTOPKGTESTS.)
.TP
.B \-\-no\-autoremovals
Investigate and show only testing propagation excuses, not autoremovals.
.TP
\fB\-\-experimental\fR, \fB\-e\fR
Print pseudo-excuses for manual migration from experimental to unstable.
.TP
.B \-\-debug
Print debugging output to stderr (including url(s) fetched).
.SH "CONFIGURATION VARIABLES"
The two configuration files \fI/etc/devscripts.conf\fR and
\fI~/.devscripts\fR are sourced in that order to set configuration
variables.  Command line options can be used to override configuration
file settings.  Environment variable settings are ignored for this
purpose.  The currently recognised variable is:
.TP
.B GREP_EXCUSES_MAINTAINER
The default maintainer, email or package to grep for if none is
specified on the command line.
.TP
.B GREP_EXCUSES_AUTOPKGTESTS
Boolean: whether to show autopkgtest failures in other packages.
See
.BR \-\-autopkgtests .
.SH "SEE ALSO"
.BR devscripts.conf (5)
.SH AUTHOR
Joey Hess <joeyh@debian.org>;
modifications by Julian Gilbey <jdg@debian.org>.
